<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" lang="en">
<head>
 <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
 <meta name="Page-topic" content="FsrchN()" />
 <meta name="Description" content="ST-Open Libraries: FsrchN()" />
 <meta name="Keywords" content="ST-Open Software, Open Source, ST-Open, Software, Library, Libraries, free Software, Assembler, C" />
 <meta name="date" content="2009-05-08T00:00:00+00:00" />
 <meta name="robots" content="index,follow" />
 <meta name="revisit-after" content="14 days" />
 <meta name="generator" content="Bernhard Schornak, handwritten" />
 <style type="text/css"><!--@import "../../st.css";--></style>
 <link rel="SHORTCUT ICON" href="../../../../pics/favicon.ico" />
 <title>FsrchN()</title>
</head>
<body id="top">
<div class="pagehd">
<div id="menu">
<ul>
 <li><a href="../../../index.htm">ST-Software</a></li>
 <li><a href="../tut/index.htm">Tutorials</a></li>
 <li><a href="../index.htm">Documentation</a></li>
 <li><a href="../alp.htm">alphabetical</a></li>
 <li><a href="../fct.htm">by Function</a></li>
</ul>
</div>
<div class="update">[2009-05-08]</div><div class="headpc"><img src="../../pics/ste.png" alt="SourceDoc Logo" width="75" height="75" border="0" /></div>
</div>
<div class="crlf1"></div>
&#160;&#160;&#160;<a href="../index.htm"><img src="../../../../pics/nav_up.png" alt="up" width="20" height="20" border="0" title="up" /></a>
&#160;&#160;&#160;<a href="fh_09.htm"><img src="../../../../pics/nav_bk.png" alt="previous" width="20" height="20" border="0" title="previous" /></a>
&#160;&#160;&#160;<a href="fh_0B.htm"><img src="../../../../pics/nav_fw.png" alt="next" width="20" height="20" border="0" title="next" /></a>
<div class="text100"><div class="inner">..\st7\lib\sources\fh\fh.S</div><div class="outer"><big>fh.lib</big></div></div>
<div class="crlf1"></div>
<div class="text100"><div class="inner"><b>FsrchN</b></div><div class="outer">Function</div></div><div class="crlf0"></div>
<div class="text100"><div class="inner">rc = FsrchN(muster, MemHandle, Untfield, start, annumber);</div><div class="outer">Call</div></div><div class="crlf0"></div>
<div class="text100"><div class="inner">
<div class="inners">VOID *</div>
<div class="inners">muster</div>
<div class="innerl">address des Suchmuster</div>
<div class="crlf0"></div>
<div class="inners">DD</div>
<div class="inners">MemHandle</div>
<div class="innerl">MemHandle des targetfeldes</div>
<div class="crlf0"></div>
<div class="inners">DD</div>
<div class="inners">Untfield</div>
<div class="innerl">subfieldnummer</div>
<div class="crlf0"></div>
<div class="inners">DD</div>
<div class="inners">start</div>
<div class="innerl">erster zu &uuml;berschreibender entry</div>
<div class="crlf0"></div>
<div class="inners">DD</div>
<div class="inners">annumber</div>
<div class="innerl">maximale amount an Eintr&auml;ge</div>
</div><div class="outer">Input</div></div><div class="crlf0"></div>
<div class="text100"><div class="inner">
<div class="inners">DD</div>
<div class="inners">rc</div>
<div class="innerl">00000000 Fehler oder keine &Uuml;bereinstimmung<div class="crlf0"></div>xxxxxxxx amount gefundener Dateien</div>
</div><div class="outer">Output</div></div><div class="crlf0"></div>
<div class="text100"><div class="inner">
FsrchN() durchsucht das Dateisystem nach dem &uuml;bergebenen Muster. Bis zu [annumber] gefundene filenamen (ohne Pfad) werden im angegebenen subfield des angegebenen fieldes gespeichert.
<div class="crlf1"></div>
<b>ACHTUNG:</b> Ist [start] Null, so wird das gesamte field wird vor dem Suchen gel&ouml;scht!
</div><div class="outer">Description</div></div><div class="crlf0"></div>
<div class="text100"><div class="inner">
DD MyFunction(DD mh)
<pre>
{
 DD rc;
 rc = FsrchN("*.ego", mh, 0, 0, 256);
 return(rc);
}
</pre>
Das aktsource Verzeichnis wird nach Dateien mit der Endung "ego" durchsucht. Da [start] Null ist, wird das field vor der Suche gel&ouml;scht. Bis zu 256 gefundene filenamen (ohne
 Pfad) werden im field [mh], subfield 0 gespeichert. Der R&uuml;ckgabewert rc enth&auml;lt die amount gefundener Dateien. Ist er Null, dann wurde kein Verzeichnis gefunden, bzw.
 ein Fehler f&uuml;hrte zum Abbruch der Function.
</div><div class="outer">Example</div></div>
<div class="crlf2"></div>
&#160;&#160;&#160;<a href="../index.htm"><img src="../../../../pics/nav_up.png" alt="up" width="20" height="20" border="0" title="up" /></a>
&#160;&#160;&#160;<a href="fh_09.htm"><img src="../../../../pics/nav_bk.png" alt="previous" width="20" height="20" border="0" title="previous" /></a>
&#160;&#160;&#160;<a href="fh_0B.htm"><img src="../../../../pics/nav_fw.png" alt="next" width="20" height="20" border="0" title="next" /></a>
<div class="crlf1"></div>
&#160;&#160;&#160;<a href="http://validator.w3.org/check?uri=http%3A%2F%2Fst-open.com%2Fst-open%2Fdoc%2Fe%2Fmsc%2Ffh_10.htm">
<img src="../../../../pics/xhtml.png" alt="validHTML" width="100" height="35" border="0" title="validate XHTML" /></a>
<div class="crlf1"></div>
</body>
</html>
